# Claude Code使用

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

本文档介绍在Quectel Pi H1上安装、配置并使用Claude Code的基本方法。Claude Code可在终端中协助完成代码编写、文件修改、命令执行和项目分析等工作，适合用于板端应用开发、脚本调试和示例工程验证。

Claude Code官方文档请参考：[Claude Code Docs](<https://code.claude.com/docs/zh-CN/overview>)。

# 准备工作

在开始安装前，请确认满足以下条件：

- 设备已连接网络；

- 当前用户具有 *sudo* 权限；

- 已获取Claude Code服务地址、访问令牌和模型名称等配置参数。

本文示例中的 *`<your_api_token>`*、*`<your_base_url>`* 和 *`<model_name>`* 请替换为实际获取到的参数。

# 安装步骤

## 安装基础工具

更新系统软件源，并安装 *curl*、*git* 等基础工具：

```bash
sudo apt update
sudo apt install -y curl git ca-certificates build-essential jq
```

## 安装Node.js 22

Claude Code通过npm安装，建议使用Node.js 22或更新版本。可通过NodeSource安装Node.js 22：

```bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
```

安装完成后，验证Node.js和npm版本：

```bash
node -v
npm -v
```

若终端能够正常输出版本号，则表示Node.js环境已安装完成。

## 安装Claude Code

使用npm全局安装Claude Code：

```bash
sudo npm install -g @anthropic-ai/claude-code
```

安装完成后，验证Claude Code是否可用：

```bash
claude --version
```

若终端能够正常输出版本号，则表示安装成功。

# 配置访问参数

## 使用官方服务

如果直接使用官方Claude Code服务，在当前终端中设置访问令牌：

```bash
export ANTHROPIC_AUTH_TOKEN=<your_api_token>
```

## 使用代理或企业网关

如果通过代理服务或企业网关访问，同时配置服务地址、访问令牌和模型参数：

```bash
export ANTHROPIC_BASE_URL=<your_base_url>export ANTHROPIC_AUTH_TOKEN=<your_api_token>export API_TIMEOUT_MS=600000export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1export ANTHROPIC_MODEL=<model_name>export ANTHROPIC_SMALL_FAST_MODEL=<small_fast_model_name>
```

参数说明如下：

| <div style="text-align: center"><br><strong>参数</strong><br></div> | <div style="text-align: center"><br><strong>说明</strong><br></div> |
| --- | --- |
| ANTHROPIC_BASE_URL | API服务地址。使用官方服务时通常无需设置。 |
| ANTHROPIC_AUTH_TOKEN | Claude Code访问令牌。 |
| API_TIMEOUT_MS | API请求等待时间，网络较慢或模型响应较慢时可适当调大。 |
| CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | 设置为1后关闭非必要流量。 |
| ANTHROPIC_MODEL | 默认使用的主模型。 |
| ANTHROPIC_SMALL_FAST_MODEL | 默认使用的轻量快速模型。 |

上述 *export* 命令只对当前终端会话生效。若需要长期生效，可将环境变量写入 *~/.bashrc* 或其他shell配置文件中。

# 启动Claude Code

完成安装和环境变量配置后，在终端中执行以下命令启动Claude Code：

```bash
claude
```

首次启动时，Claude Code可能会进行登录校验、配置确认或权限提示。请根据终端提示完成初始化。

# 使用示例

## 生成GPIO灯光闪烁的代码

进入需要开发或调试的项目目录后，可直接向Claude Code输入任务描述。

```plaintext
参考 Quectel Pi H1 的 40-Pin 扩展文档，编写并运行一个控制 GPIO_36 灯光闪烁的测试程序。GPIO_36 对应物理引脚 Pin3。
```

相关引脚说明可参考：[40-Pin扩展](<../../使用指南/40-Pin扩展/40-Pin扩展.md>)。

```{image} images/image_IuhFbnWuioeDJGxt2UucYc9onth.webp
:width: 892px
:height: 498px
```

```{image} images/image_ZKZ9bLAYBo1CzvxecVacokMBnTe.webp
:width: 892px
:height: 414px
```

在执行此类硬件控制任务前，建议先确认以下内容：

- 目标引脚当前未被I2C、SPI、UART或其他系统功能占用；

- GPIO电平与外设电压兼容；

- 需要控制GPIO时，当前用户具备访问GPIO设备节点的权限。

## 分析项目代码结构

进入需要分析的项目目录，启动Claude Code后输入分析指令：

```bash
cd ~/my_project
claude
```

在Claude Code交互界面中输入任务描述，例如：

```plaintext
分析当前项目的代码结构，列出主要模块、入口文件和依赖关系。
```

Claude Code会自动读取项目中的文件和目录，输出代码结构概览、模块划分及调用关系等信息，帮助快速了解陌生项目的整体架构。

```{image} images/image_WGK8bC3XMoPlrvxJkIVczRoInsb.webp
:width: 576px
:height: 472px
```

# 常用命令

查看Claude Code版本：

```bash
claude --version
```

查看Claude Code帮助信息：

```bash
claude --help
```

进入项目目录并启动Claude Code：

```bash
cd <project_path>
claude
```

管理对话：

| <div style="text-align: center"><br><strong>命令</strong><br></div> | <div style="text-align: center"><br><strong>功能</strong><br></div> |
| --- | --- |
| claude --continue | 恢复当前目录中最近的会话 |
| claude --resume | 打开会话管理器 |
| claude --resume | 直接恢复命名的会话 |
| claude --from-pr | 恢复链接到该拉取请求的会话 |
| /resume | 从活跃会话内切换到不同的对话 |

# 问题处理

- 若执行 *claude* 后提示命令不存在，请重新确认npm全局安装是否成功，并检查npm全局命令目录是否已加入 *PATH*；

- 若 *npm install* 下载较慢，可根据实际网络环境配置npm镜像源后重新安装；

- 若启动后提示认证失败，请检查 *ANTHROPIC_AUTH_TOKEN* 是否配置正确；

- 若使用代理或企业网关后无法连接，请检查 *ANTHROPIC_BASE_URL*、模型名称和网络连通性；

- 若执行硬件控制任务，请先确认引脚复用关系、GPIO访问权限和外设连接方式。